home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 25 / AMIGAplus Sonderheft 25 (2000)(Falke)(DE)(Track 1 of 4)[!].iso / PublicDomain / Spiele / Angband290 / readme.txt < prev   
Text File  |  2000-04-10  |  14KB  |  306 lines
  1.  
  2.  
  3.               **************************************************
  4.               **   Angband 2.9.0   **   The Pits of Angband   **
  5.               **************************************************
  6.  
  7.            Based on Moria:   Copyright (c) 1985 Robert Alan Koeneke
  8.                and Umoria:   Copyright (c) 1989 James E. Wilson
  9.  
  10.                        Angband 2.0 - 2.4 - 2.6.2 by:
  11.                    Alex Cutler, Andy Astrand, Sean Marsh,
  12.                  Geoff Hill, Charles Teague, Charles Swiger
  13.  
  14.                    Angband 2.7.0 - 2.8.5 by Ben Harrison
  15.  
  16.                      Angband 2.9.0 by Robert Ruehlmann
  17.  
  18.         Send comments, bug reports, and patches, to "rr9@angband.org"
  19.        Visit the Angband Home Page at "http://thangorodrim.angband.org/"
  20.       Browse the Angband newsgroup at "news:rec.games.roguelike.angband"
  21.     Read the online help files, especially "general.txt" and "version.txt"
  22.    Angband is available for Unix, X11, DOS, Windows, Macintosh, Amiga, etc.
  23.  
  24.  
  25. === General Info ===
  26.  
  27. This is the README file for Angband 2.9.0 (27th March 2000).
  28.  
  29. Angband is a "graphical" dungeon adventure game using textual characters
  30. to represent the walls and floors of a dungeon and the inhabitants therein,
  31. in the vein of "rogue", "hack", "nethack", and "moria".
  32.  
  33. There are some ascii "on line help" files in the "lib/help" directory.
  34.  
  35. See the Official Angband Home Page "http://thangorodrim.angband.org/" for
  36. a list (mostly complete) of what has changed in each recent version.
  37.  
  38. See the various Angband ftp sites (including "export.andrew.cmu.edu" and
  39. "ftp.cis.ksu.edu") for the latest files, patches, and executables.
  40.  
  41. Contact Robert Ruehlmann < rr9@angband.org > to report any bugs or to make
  42. any suggestions.  Use the newsgroup "rec.games.roguelike.angband" to ask
  43. any general questions about the game, including compilation questions.
  44.  
  45. This version of Angband will run on Macintosh, Windows, Unix (X11/Curses), 
  46. Linux (X11/Curses), Acorn, Amiga, various DOS machines, and many others...
  47.  
  48. See compile.txt, the Makefiles, h-config.h, and config.h for details on
  49. compiling.
  50. See "Makefile.xxx" and "main-xxx.c" for various supported systems.
  51.  
  52.  
  53. === Quick and dirty compilation instructions ===
  54.  
  55. For many platforms (including Macintosh and Windows), a "pre-compiled"
  56. archive is available, which contains everything you need to install and
  57. play Angband.  For other platforms, including most UNIX systems, you must
  58. compile the source code yourself.  Try the following non-trivial steps:
  59.  
  60. Step 1: Acquire.  Ftp to "export.andrew.cmu.edu:/angband/Source"
  61.                   Try "bin" and "mget angband*.tar.gz" and "y"
  62. Step 2: Extract.  Try "gunzip *.gz" then "tar -xvf *.tar"
  63. Step 3: Prepare.  Try "cd angband*/src", then edit "Makefile"
  64.                   You may also edit "h-config.h" and "config.h"
  65. Step 4: Compile.  Try "make", and then "cd .." if successful
  66. Step 5: Execute.  Try "angband -uTest" to initialize stuff
  67. Step 6: Play....  Read the "online help" via the "?" command.
  68.  
  69. Of course, if you have a compiler, you can compile a (possibly customized)
  70. executable on almost any system.  You will need the "source archive" (as
  71. above), which contains the standard "src" and "lib" directories, and for
  72. some platforms (including Macintosh and Windows), you will also need an
  73. appropriate "extra archive", which contains some extra platform specific
  74. files, and instructions about how to use them.  Some "extra archives" may
  75. be found at the ftp site (including "/angband/Macintosh/ext-mac.sit.bin"
  76. and "/angband/Windows/ext-win.zip"), but be sure that you get a version
  77. of the "extra archive" designed for Angband 2.9.0.
  78.  
  79.  
  80. === Special instructions for certain platforms ===
  81.  
  82. The Macintosh requires that the "lib" folder be in the same folder as
  83. the executable.  Also, note that System 7.5 (and perhaps others) are
  84. brain damaged, and may default to the incorrect folder for opening
  85. savefiles.  Make sure you keep all your savefiles in the proper place,
  86. and if you load a savefile from the wrong place, note that the game
  87. may decide to re-save your savefile in the proper place when you quit.
  88. If you move the "lib" folder (or any ancestor folder) while a game is
  89. in progress, you may not be able to save your game.  To use a savefile
  90. from another platform (or really old version of Angband) you must use
  91. the "Import..." menu command instead of the "Open..." menu command.
  92.  
  93. Some archive generation programs refuse to handle empty directories,
  94. so special "fake" files with names like "DELETEME.TXT" may have been
  95. placed into certain directories to avoid this problem.  You may safely
  96. delete these files if you so desire.
  97.  
  98.  
  99. === Upgrading from older versions (and/or other platforms) ===
  100.  
  101. If you have been using an older version of Angband (and/or playing on a
  102. different platform), you can "upgrade" (or "sidegrade") to Angband 2.9.0,
  103. bringing your old savefiles, high score list, and other files with you.
  104.  
  105. Angband 2.9.0 uses a platform independant file format for the binary files
  106. that store information about games in progress, known as "savefiles", and
  107. is able to translate savefiles from all known versions of Angband.  To use
  108. an "old" savefile, simply copy it into the "lib/save" directory, changing
  109. the name of the savefile (if necessary) to satisfy the requirements of the
  110. platform you are using.  In general, the savefile should be named "UUU.NNN"
  111. or "NNN" where "UUU" is the userid of the player (on "multiuser" systems),
  112. and "NNN" is the name of the "character" in the savefile.  Note that only
  113. "multiuser" platforms use the "UUU.NNN" form, and the "dot" is required.
  114.  
  115. Angband 2.9.0 uses a platform independant file format for the binary file
  116. used to store the high score list.  This file is named "scores.raw".  To
  117. use an "old" high score list, simply copy it into the "lib/apex" directory.
  118.  
  119. Angband 2.9.0 uses a set of special ascii "configuration files" which are
  120. kept in the "lib/file" directory.  These files should not be modified (or
  121. imported from older versions) unless you know exactly what you are doing,
  122. but often you can use "old" versions of these files with little trouble.
  123.  
  124. Angband 2.9.0 uses a set of ascii "user pref files" which are kept in the
  125. "lib/user" directory.  Most of these files can only be used on a small set
  126. of platforms, and may need slight modifications when imported from older
  127. versions.  Note that only some of these files are auto-loaded by the game.
  128.  
  129.  
  130. === Directory "src" ===
  131.  
  132. The "src" directory contains the complete set of "standard" source files.
  133.  
  134.  
  135. === Directory "lib" ===
  136.  
  137. The "lib" directory contains all of Angband's special sub-directories.
  138.  
  139.  
  140. === Directory "lib/apex" ===
  141.  
  142. The "lib/apex" directory contains the "high score" files.
  143.  
  144. The "scores.raw" file contains the "high score" table, in a "semi-binary" form,
  145. that is, all the bytes in the file are normal ascii values, but this includes
  146. the special "nul" or "zero" byte, which is used to separate and pad records.
  147. You should probably not attempt to modify this file with a normal text editor.
  148. This file should be (more or less) portable between different platforms.  It
  149. must be present (or creatable) for the game to run correctly.
  150.  
  151.  
  152. === Directory "lib/bone" ===
  153.  
  154. The "lib/bone" directory is currently unused.
  155.  
  156.  
  157. === Directory "lib/data" ===
  158.  
  159. The "lib/data" directory contains various special binary data files.
  160.  
  161. The files 'f_info.raw', 'k_info.raw', 'a_info.raw', 'e_info.raw', 'r_info.raw',
  162. and 'v_info.raw' are binary image files constructed by parsing the ascii
  163. template files in "lib/edit", described below.  These files are required,
  164. but can be created by the game if the "lib/edit" directory contains the
  165. proper files, and if the game was compiled to allow this creation.
  166.  
  167.  
  168. === Directory "lib/edit" ===
  169.  
  170. The "lib/edit" directory contains various special ascii data files.
  171.  
  172. The files 'f_info.txt', 'k_info.txt', 'a_info.txt', 'e_info.txt', 'r_info.txt',
  173. and 'v_info.txt' are ascii template files used to construct the binary image
  174. files in "lib/data", described above.  These files describe the "terrain
  175. features", "object kinds", "artifacts", "ego-items", "monster races", and
  176. "dungeon vaults", respectively.
  177.  
  178. The ascii template files are easier to edit than hard-coded arrays,